Skip to content

Resumable file upload - #499

Open
diogoosz wants to merge 1 commit into
javascript-tutorial:masterfrom
diogoosz:translate-resumable-upload
Open

diogoosz wants to merge 1 commit into
javascript-tutorial:masterfrom
diogoosz:translate-resumable-upload

Conversation

@diogoosz

Copy link
Copy Markdown
Contributor

Resumo

Traduz o artigo "Resumable file upload" para o português. Como a demo embutida via [codetabs src="upload-resume"] é mostrada inline ao leitor como código para baixar, também traduzi upload-resume.view/index.html, uploader.js e server.js (comentários e os textos de status HTTP que o servidor retorna); as chamadas de debug() (log interno do servidor, não visível ao leitor) ficaram como estão.

Plano de teste

  • Diff de todos os trechos de código (code spans) entre o original em inglês e a tradução.
  • Grep em busca de falsos cognatos conhecidos e registro informal.
  • Releitura manual completa para checar sentido e concordância.

🤖 Generated with Claude Code

Also translates the embedded demo shown via [codetabs]
(upload-resume.view/index.html, uploader.js, server.js), including
comments and the HTTP status texts the server returns, since the
demo is presented inline to the reader as downloadable code.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@@ -1,82 +1,82 @@
# Resumable file upload

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Importante: o título do artigo ficou sem tradução. Ele aparece no índice e no topo da página, então vale traduzir também. Uma sugestão, mantendo o termo "upload" que você já usa no restante do texto:

Suggested change
# Resumable file upload
# Upload de arquivo retomável

Como retomar o upload depois de perder a conexão? Não existe nenhuma opção nativa para isso, mas temos as peças para implementá-lo.

Resumable uploads should come with upload progress indication, as we expect big files (if we may need to resume). So, as `fetch` doesn't allow to track upload progress, we'll use [XMLHttpRequest](info:xmlhttprequest).
Uploads retomáveis devem vir com indicação de progresso de upload, já que esperamos arquivos grandes (se é que podemos precisar retomar). Então, como `fetch` não permite acompanhar o progresso de upload, vamos usar o [XMLHttpRequest](info:xmlhttprequest).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Detalhe (opcional): "se é que podemos precisar retomar" acrescenta um tom de dúvida que o original não tem. Em "(if we may need to resume)", o autor só explica que, com arquivos grandes, talvez seja preciso retomar o envio. Que tal assim?

Suggested change
Uploads retomáveis devem vir com indicação de progresso de upload, já que esperamos arquivos grandes (se é que podemos precisar retomar). Então, como `fetch` não permite acompanhar o progresso de upload, vamos usar o [XMLHttpRequest](info:xmlhttprequest).
Uploads retomáveis devem vir com indicação de progresso de upload, já que esperamos arquivos grandes (que talvez precisem ser retomados). Então, como `fetch` não permite acompanhar o progresso de upload, vamos usar o [XMLHttpRequest](info:xmlhttprequest).

## Algoritmo

1. First, create a file id, to uniquely identify the file we're going to upload:
1. Primeiro, cria um id de arquivo, para identificar unicamente o arquivo que vamos enviar:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Detalhe (opcional): os passos do algoritmo são instruções ao leitor, e o texto trata o leitor por "você" (por exemplo, "você pode baixá-la"). Então o imperativo fica "crie" em vez de "cria". O mesmo vale para a linha 33: "Envie uma requisição ao servidor..." em vez de "Envia".

Suggested change
1. Primeiro, cria um id de arquivo, para identificar unicamente o arquivo que vamos enviar:
1. Primeiro, crie um id de arquivo, para identificar unicamente o arquivo que vamos enviar:

xhr.setRequestHeader('X-Start-Byte', startByte);

xhr.upload.onprogress = (e) => {
console.log(`Uploaded ${startByte + e.loaded} of ${startByte + e.total}`);

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Detalhe (opcional): o texto deste console.log ficou em inglês, enquanto o mesmo trecho em uploader.js foi traduzido. Como textos dentro do código podem ser traduzidos, fica mais coerente assim:

Suggested change
console.log(`Uploaded ${startByte + e.loaded} of ${startByte + e.total}`);
console.log(`Enviado ${startByte + e.loaded} de ${startByte + e.total}`);

```

Here we send the server both file id as `X-File-Id`, so it knows which file we're uploading, and the starting byte as `X-Start-Byte`, so it knows we're not uploading it initially, but resuming.
Aqui enviamos ao servidor tanto o id do arquivo como `X-File-Id`, para que ele saiba qual arquivo estamos enviando, quanto o byte inicial como `X-Start-Byte`, para que ele saiba que não estamos enviando pela primeira vez, mas retomando.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Detalhe (opcional): como "tanto ... como" também é um par correlativo em português, a frase pode ser lida como "tanto o id do arquivo quanto o X-File-Id", e o "quanto" seguinte fica sem par. A ideia do original é que cada informação vai em um cabeçalho. Uma sugestão para evitar a ambiguidade:

Suggested change
Aqui enviamos ao servidor tanto o id do arquivo como `X-File-Id`, para que ele saiba qual arquivo estamos enviando, quanto o byte inicial como `X-Start-Byte`, para que ele saiba que não estamos enviando pela primeira vez, mas retomando.
Aqui enviamos ao servidor o id do arquivo no cabeçalho `X-File-Id`, para que ele saiba qual arquivo estamos enviando, e o byte inicial no cabeçalho `X-Start-Byte`, para que ele saiba que não estamos enviando pela primeira vez, mas retomando.

// poderíamos usar um caminho real em vez disso, por exemplo
// let filePath = path.join('/tmp', fileId);

debug("onUpload fileId: ", fileId);

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Detalhe (opcional): as mensagens de depuração (debug(...)) deste arquivo continuaram em inglês, enquanto o console.log da linha 120 foi traduzido. Ficaram assim as linhas 25, 41, 53, 58, 68, 76 e 83 (por exemplo, "New file created", "File reopened", "Upload finished", "File unfinished, stopped at", "fileStream error"). Se a ideia for traduzir os textos do exemplo, vale incluir essas também, sempre mantendo os nomes de variáveis como fileId e bytesReceived.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants